Jupyter Notebook 설치 및 실행 방법 정리 | ✅ 편저: 코담 운영자

💻 Jupyter Notebook 설치 및 실행 방법 정리

Python 데이터 분석을 위한 최고의 도구인 Jupyter Notebook을 설치하고, VS Code 또는 웹 브라우저에서 실행하는 방법을 깔끔하게 정리했습니다.

---

✅ 1. Jupyter Notebook 설치 방법

🔹 pip 사용 시 (Python 환경에 이미 설치되어 있다면)

pip install notebook

🔹 pip 외 다른 설치 방법

• conda (Anaconda 사용 시):

conda install -c conda-forge notebook

• Jupyter Lab (업그레이드 버전) 설치:

pip install jupyterlab

---

✅ 2. VS Code에서 Jupyter Notebook 실행

① 필수 조건

• Python 설치

• VS Code 설치

• Python 인터프리터 설정 완료

② 확장 프로그램 설치

• VS Code 좌측 Extensions(확장) 탭에서 Jupyter 검색 후 설치

③ 실행 방법

1. .ipynb 파일을 열거나 새 파일 생성

2. 오른쪽 상단 '커널'을 선택하여 실행 환경 지정

3. 셀에 코드를 입력하고 ▶ 실행 버튼 클릭

✅ 장점

• 코드 작성 + 시각화 + 버전 관리 모두 가능

• Git 연동이 편리함

• 하나의 에디터로 개발 + 분석 모두 처리 가능

---

✅ 3. 웹 브라우저에서 Jupyter Notebook 실행

① 터미널 명령어로 실행

jupyter notebook

또는 Lab 버전 사용 시:

jupyter lab

② 자동으로 열리는 브라우저 주소

http://localhost:8888

③ .ipynb 파일 생성 및 실행

• Jupyter Dashboard에서 [New] 버튼 → Python 3 선택

• 셀에 코드 입력 후 Shift+Enter로 실행

✅ 웹 브라우저에서의 기본 사용법

기능	사용법
셀 추가	상단 메뉴 → Insert → Insert Cell Below / Above
셀 실행	Shift + Enter 또는 상단 ▶ 버튼
셀 삭제	셀 선택 후 상단 메뉴 Edit → Delete Cells
셀 타입 변경	상단 툴바에서 Code / Markdown 선택
마크다운 문서 작성	셀을 Markdown 타입으로 바꾸고 텍스트 입력
저장	Ctrl + S 또는 File → Save and Checkpoint
자동 저장 주기 설정	File → Trust Notebook (자동저장 활성화 필요 시)

✅ 장점

• 빠르고 가벼운 실행 환경

• 셋업이 간단하고 초보자 친화적

• 다양한 브라우저에서 실습 가능

---

🔐 비밀번호 또는 토큰 요청 시 대처 방법

Jupyter Notebook 실행 시 브라우저에서 비밀번호 또는 토큰을 입력하라고 나오는 경우가 있습니다.

🔹 기본 상황

http://localhost:8888
Password or token:

🔸 ① 토큰 확인 방법

터미널에서 실행했을 때 출력되는 URL을 보면 다음과 같이 토큰이 포함된 주소가 나타납니다:

http://localhost:8888/?token=abcdef123456...

이 주소 전체를 브라우저에 복사해서 접속하면 바로 들어갈 수 있습니다.

🔸 ② 비밀번호 재설정 방법

토큰 없이 로그인하거나, 직접 비밀번호를 설정하고 싶은 경우 아래 명령어 실행:

jupyter notebook password

실행 후 다음처럼 새 비밀번호를 설정하면 됩니다:

Enter password:
Verify password:
[NotebookApp] Wrote hashed password to ~/.jupyter/jupyter_notebook_config.json

🔸 ③ 비밀번호 초기화 (재설정이 안될 경우)

아래 파일을 삭제하면 기존 비밀번호 설정이 초기화됩니다:

rm ~/.jupyter/jupyter_notebook_config.json

그 후 다시 jupyter notebook password로 설정 가능합니다.

---

📌 참고 사항

• Jupyter는 .ipynb 확장자를 가진 파일을 사용합니다.

• 코드 셀과 마크다운 셀을 구분하여 문서형 코드 작성이 가능합니다.

• 웹 기반 실행은 Ctrl+C로 종료할 수 있으며, --port, --no-browser 옵션으로 설정 가능

jupyter notebook --port=8889 --no-browser

🔍 명령어 설명: jupyter notebook --no-browser --port=8888

옵션	설명
--no-browser	브라우저를 자동으로 열지 않음 (직접 접속해야 함)
--port=8888	8888 포트에서 서버 실행 (기본값도 8888이지만 명시 가능)

✅ 언제 사용하나?

• 원격 서버에서 실행할 때:

  ssh -L 8888:localhost:8888 user@your-server-ip
  

  위와 같이 로컬 포트와 원격 포트를 연결 후, 로컬 브라우저에서 접속

• 브라우저 자동 실행을 원하지 않을 때: 주소를 직접 복사해 원하는 브라우저에서 열고자 할 때 사용

실행하면 다음과 같은 메시지가 출력됩니다:

To access the notebook, open this file in a browser:
    http://localhost:8888/?token=abc123...

이 URL을 복사해서 직접 브라우저에 붙여넣으면 됩니다.

---

📊 추천 사용 시나리오

사용 환경	추천 방식
데이터 분석 + 보고서 작성	Jupyter (웹 브라우저)
개발과 분석을 동시에	VS Code Jupyter 확장
클라우드/협업 필요	Google Colab, JupyterHub

---